@terra-symposium/docs 0.1.17 → 0.1.71

package/README.md

@@ -27,6 +27,8 @@ pnpm dev        # Vite component playground
 pnpm docs:dev   # Astro installation and configuration guide
 ```
 
+The launcher delegates port acquisition to Terra Quality, then starts the dev server with strict port handling. Host apps use this shared launcher; set DOCS_DEV_PORT to override their preferred port.
+
 Build commands: `pnpm run check`, `pnpm run build`, `pnpm run build:demo`, and `pnpm run docs:build`.
 
 The reusable block registry includes accordions, tabs, tables, callouts, code, images, embeds, math, diagrams, raw Markdown, and TypeScript documentation. All are available by default; hosts can disable individual members with the `blocks` prop. Local repository pages stay read-only in the browser.
@@ -68,6 +70,4 @@ const sections: DocsSection[] = [
 </DocsSiteLayout>;
 ```
 
-Repository-backed hosts omit `capabilities`, so the browser shows View and Attachments. Remote hosts pass a `DocsRemoteProvider`, grant `capabilities={{ edit: true, save: true, history: true, publish: true }}`, and wire save, history, and publish callbacks after their own permission checks. These callbacks do not bypass host authorization. Astro hosts can use `@terra-symposium/docs/site-layout.astro` for read-only pages.
-
-For a mutable tree, pass `treeActions` to `DocsSiteLayout`. Its `available(action)` function decides which section, group, and leaf menu items to show; `perform(action)` persists a requested operation through the host. Supported requests include create, rename, duplicate, move or reorder, attachment management, download, and deletion. The host must check permissions again on the server and return an error if the mutation fails. Read-only hosts omit `treeActions` and retain leaf links, Copy link, Open in new tab, and Attachments view.
+`DocsSiteLayout` delegates to the canonical shared workspace and is intended for static React pages. Repository-backed hosts should use `DocsLocalWorkspace`, which loads each leaf and its adjacent attachments from the host-provided tree and remains read-only. Remote hosts should use `TerraDocsWorkspace` with a `DocsHostAdapter`; that adapter supplies the original tree controls and performs create, rename, duplicate, reorder, attachment, export, and delete operations after applying the host's own permission checks.

package/lib-dist/assets/fonts/README.md

@@ -0,0 +1,7 @@
+# Typeface credits
+
+- **Avara Bold and Bold Italic** — designed by Raphaël Bastide, with contributions by Wei Huang, Lucas Le Bihan, Walid Bouchouchi, and Jérémy Landes; released by [Velvetyne Type Foundry](https://velvetyne.fr/fonts/avara/). Licensed under the SIL Open Font License 1.1. See [licenses/OFL-1.1.txt](licenses/OFL-1.1.txt).
+- **AUTHENTIC Sans 90, 130, and 150** — distributed by [AUTHENTIC](https://authentic.website/sans) under the WTFPL.
+- **Inter Variable Roman and Italic** — Copyright (c) 2016 The Inter Project Authors; licensed under the SIL Open Font License 1.1. The files match the Inter font files used by the original Terra Docs host. See [licenses/Inter-OFL-1.1.txt](licenses/Inter-OFL-1.1.txt) and [the Inter project](https://github.com/rsms/inter).
+
+The font files are distributed unchanged from the copies already used by the Terra Symposium website, except Inter is included locally because its original Sanity CSS dependency did not travel with Docs. Their licenses are separate from the Apache-2.0 license for this package.

package/lib-dist/assets/fonts/licenses/Inter-OFL-1.1.txt

@@ -0,0 +1,92 @@
+Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/lib-dist/assets/fonts/licenses/OFL-1.1.txt

@@ -0,0 +1,93 @@
+Copyright 2011-2019 Raphaël Bastide, Wei Huang, Lucas Le Bihan, Walid Bouchouchi, and Jérémy Landes.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/lib-dist/{Docs.d.ts → components/Docs.d.ts}

@@ -17,6 +17,6 @@ export type DocsProps = {
     mode: 'view';
     onChange?: never;
 });
-/** A minimal standalone version of TerraContentEditor's Portable Text surface. */
+/** Controlled editor surface backed by the canonical Terra Docs editor. */
 export declare function Docs(props: DocsProps): JSX.Element;
 //# sourceMappingURL=Docs.d.ts.map

package/lib-dist/components/Docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Docs.d.ts","sourceRoot":"","sources":["../../src/components/Docs.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAElG,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAalD"}

package/lib-dist/components/Docs.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { TerraContentEditor } from './terra/editor/TerraContentEditor.js';
+/** Controlled editor surface backed by the canonical Terra Docs editor. */
+export function Docs(props) {
+    return (_jsx("div", { className: ['terra-docs', props.className].filter(Boolean).join(' '), children: _jsx(TerraContentEditor, { content: props.value, readOnly: props.mode === 'view', ...(props.blocks !== undefined ? { blocks: props.blocks } : {}), ...(props.mode === 'edit'
+                ? { onChange: (value) => props.onChange(value) }
+                : {}) }) }));
+}
+//# sourceMappingURL=Docs.js.map

package/lib-dist/components/Docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Docs.js","sourceRoot":"","sources":["../../src/components/Docs.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAkB1E,2EAA2E;AAC3E,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,OAAO,CACL,cAAK,SAAS,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YACvE,KAAC,kBAAkB,IACjB,OAAO,EAAE,KAAK,CAAC,KAAK,EACpB,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,MAAM,KAC3B,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC5D,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;gBACxB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAkB,CAAC,EAAE;gBACxE,CAAC,CAAC,EAAE,CAAC,GACP,GACE,CACP,CAAC;AACJ,CAAC"}

package/lib-dist/{LocalDocsWorkspace.d.ts → components/LocalDocsWorkspace.d.ts}

@@ -1,5 +1,6 @@
-import type { DocsHostAttachment, DocsHostTreeNode, DocsCustomBlock } from './host.js';
-import type { JSX } from 'react';
+import type { DocsBlockOptions } from './blocks.js';
+import type { DocsHostAttachment, DocsHostTreeNode, DocsCustomBlock } from '../lib/host.js';
+import type { JSX, ReactNode } from 'react';
 /** A local page supplied by a repository or static site build. */
 export type DocsLocalPage = {
     id: string;
@@ -18,10 +19,16 @@ export type DocsLocalWorkspaceProps = {
     pathname: string;
     title: string;
     description?: string;
+    /** Optional host-owned content rendered before the page body in View mode. */
+    beforeContent?: ReactNode;
+    hue?: number | null;
     rootPath?: string;
     homePath?: string;
+    afterContent?: ReactNode;
     customBlocks?: DocsCustomBlock[];
+    blocks?: DocsBlockOptions;
 };
+export declare function findDocsLocalPage(pages: DocsLocalPage[], value: unknown): DocsLocalPage | undefined;
 /**
  * Render repository-owned Markdown with the original Terra Docs workspace.
  * This adapter has no write operations, account dependency, or server requirement.

package/lib-dist/components/LocalDocsWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDocsWorkspace.d.ts","sourceRoot":"","sources":["../../src/components/LocalDocsWorkspace.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAIV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAqBF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EAAE,EACtB,KAAK,EAAE,OAAO,GACb,aAAa,GAAG,SAAS,CAwB3B;AAsCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,GAAG,CAAC,OAAO,CAiK9E"}

package/lib-dist/{LocalDocsWorkspace.js → components/LocalDocsWorkspace.js}

@@ -1,11 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from 'react';
-import { markdownToDocsValue } from './markdown-model.js';
+import { markdownToDocsValue } from '../lib/markdown-model.js';
 import { TerraDocsWorkspace } from './terra/Workspace.js';
 function normalized(value, base = 'http://docs.local') {
     try {
         const url = new URL(value, base);
-        return `${url.pathname}${url.search}${url.hash}`;
+        // Mode and other host query parameters describe the surface, not the page.
+        return `${url.pathname}${url.hash}`;
     }
     catch {
         return value;
@@ -20,13 +21,29 @@ function routeId(value) {
         return '';
     }
 }
-function findPage(pages, value) {
+export function findDocsLocalPage(pages, value) {
     if (typeof value !== 'string' || !value)
         return undefined;
     const route = normalized(value);
-    const pathOnly = normalized(value).split(/[?#]/, 1)[0];
+    const pathOnly = route.split('#', 1)[0];
     const id = routeId(value);
-    return pages.find(page => page.id === value || page.id === id || page.path === value || normalized(page.pathname) === route || normalized(page.pathname).split(/[?#]/, 1)[0] === pathOnly);
+    // Hash-addressed pages must win before a shared pathname such as `/`.
+    if (id) {
+        const byId = pages.find((page) => page.id === id);
+        if (byId)
+            return byId;
+    }
+    const exactRoute = pages.find((page) => normalized(page.pathname) === route);
+    if (exactRoute)
+        return exactRoute;
+    const direct = pages.find((page) => page.id === value || page.path === value);
+    if (direct)
+        return direct;
+    // A root page is the fallback for `/` only. It must not shadow `/` + #leaf.
+    if (pathOnly === '/' && !id) {
+        return pages.find((page) => normalized(page.pathname) === '/');
+    }
+    return pages.find((page) => normalized(page.pathname).split('#', 1)[0] === pathOnly);
 }
 function findTreeNode(nodes, id, ancestors = []) {
     for (const node of nodes) {
@@ -39,6 +56,16 @@ function findTreeNode(nodes, id, ancestors = []) {
     }
     return undefined;
 }
+function findTreeLeaf(nodes, id, ancestors = []) {
+    for (const node of nodes) {
+        if (node.type === 'leaf' && node.origName === id)
+            return { node, ancestors };
+        const found = node.children ? findTreeLeaf(node.children, id, [...ancestors, node]) : undefined;
+        if (found)
+            return found;
+    }
+    return undefined;
+}
 function firstLeaf(nodes) {
     for (const node of nodes) {
         if (node.type === 'leaf')
@@ -54,41 +81,57 @@ function firstLeaf(nodes) {
  * This adapter has no write operations, account dependency, or server requirement.
  */
 export function DocsLocalWorkspace(props) {
-    const { tree, pages, pathname, title, description, rootPath = '/', homePath, customBlocks } = props;
-    const page = findPage(pages, pathname) ?? pages[0];
-    const content = useMemo(() => page ? markdownToDocsValue(page.markdown) : [], [page]);
+    const { tree, pages, pathname, title, description, beforeContent, hue = 145, rootPath = '/', homePath, afterContent, customBlocks, blocks, } = props;
+    const page = findDocsLocalPage(pages, pathname) ?? pages[0];
+    const content = useMemo(() => (page ? markdownToDocsValue(page.markdown, blocks) : []), [blocks, page]);
     const host = useMemo(() => {
         const activePage = () => typeof window === 'undefined'
             ? page
-            : findPage(pages, `${window.location.pathname}${window.location.search}${window.location.hash}`) ?? page;
+            : (findDocsLocalPage(pages, `${window.location.pathname}${window.location.search}${window.location.hash}`) ?? page);
         const resolvePage = (input) => {
             if (!input || typeof input !== 'object')
                 return undefined;
             const value = input;
-            const direct = findPage(pages, value.path) ?? findPage(pages, value.pathname) ?? findPage(pages, value.id);
+            const direct = findDocsLocalPage(pages, value.id) ??
+                findDocsLocalPage(pages, value.path) ??
+                findDocsLocalPage(pages, value.pathname) ??
+                findDocsLocalPage(pages, value.origName);
             if (direct)
                 return direct;
-            const requested = [value.path, value.pathname, value.id].find(candidate => typeof candidate === 'string' && candidate.length > 0);
+            const requested = [value.path, value.pathname, value.id].find((candidate) => typeof candidate === 'string' && candidate.length > 0);
             if (typeof requested !== 'string')
                 return activePage();
             const basename = requested.split(/[?#]/, 1)[0]?.split('/').filter(Boolean).at(-1);
             const active = activePage();
             if (basename && active?.path.split('/').at(-1) === basename)
                 return active;
-            const matches = pages.filter(candidate => candidate.path.split('/').at(-1) === basename || candidate.id === basename);
+            const matches = pages.filter((candidate) => candidate.path.split('/').at(-1) === basename || candidate.id === basename);
             return matches.length === 1 ? matches[0] : undefined;
         };
         const adapter = {
-            capabilities: { read: true, write: false, reorder: false, attachments: false, export: true, history: false, publish: false },
+            capabilities: {
+                read: true,
+                write: false,
+                reorder: false,
+                attachments: false,
+                export: true,
+                history: false,
+                publish: false,
+            },
             rootPath,
             ...(homePath ? { homePath } : {}),
+            hue,
             siteTitle: title,
             ...(description ? { siteDescription: description } : {}),
-            assetUrl: asset => asset,
+            assetUrl: () => undefined,
             resolveRoute(value) {
-                const resolved = findPage(pages, value) ?? pages[0];
-                const match = resolved ? findTreeNode(tree, resolved.id) : undefined;
-                const branches = match?.ancestors.filter(node => node.type === 'branch') ?? [];
+                const resolved = findDocsLocalPage(pages, value) ?? pages[0];
+                // Leaf IDs may intentionally match their section IDs (for example a
+                // Standards `skills` section containing the `skills` landing leaf).
+                // Resolve the leaf explicitly so a branch collision cannot redirect
+                // the selected section to the first section in the TOC.
+                const match = resolved ? findTreeLeaf(tree, resolved.id) : undefined;
+                const branches = match?.ancestors.filter((node) => node.type === 'branch') ?? [];
                 return {
                     sectionId: branches[0]?.origName ?? tree[0]?.origName ?? 'index',
                     ...(branches[1] ? { groupId: branches[1].origName } : {}),
@@ -106,7 +149,7 @@ export function DocsLocalWorkspace(props) {
                 return firstLeaf(group?.children ?? section?.children ?? tree)?.url ?? rootPath;
             },
             routePath(path) {
-                return findPage(pages, path)?.pathname ?? rootPath;
+                return findDocsLocalPage(pages, path)?.pathname ?? rootPath;
             },
             async invoke(operation, input) {
                 const args = (input ?? {});
@@ -114,11 +157,23 @@ export function DocsLocalWorkspace(props) {
                     return { data: tree };
                 if (operation === 'read.doc.get') {
                     const document = resolvePage(args);
-                    return { data: (document ? { ...document, source: document.markdown, content: markdownToDocsValue(document.markdown) } : null) };
+                    return {
+                        data: (document
+                            ? {
+                                ...document,
+                                source: document.markdown,
+                                content: markdownToDocsValue(document.markdown),
+                            }
+                            : null),
+                    };
                 }
                 if (operation === 'read.doc.attachments') {
                     const document = resolvePage(args) ?? activePage();
-                    const attachments = (document?.attachments ?? []).map(attachment => ({ ...attachment, title: attachment.name, isMd: false }));
+                    const attachments = (document?.attachments ?? []).map((attachment) => ({
+                        ...attachment,
+                        title: attachment.name,
+                        isMd: false,
+                    }));
                     return { data: attachments };
                 }
                 if (operation === 'read.source.body')
@@ -127,7 +182,11 @@ export function DocsLocalWorkspace(props) {
                     return { data: String(args.path ?? pathname) };
                 if (operation === 'read.util.node') {
                     const document = resolvePage(args);
-                    return { data: (document ? { origName: document.id, title: document.title, path: document.path } : null) };
+                    return {
+                        data: (document
+                            ? { origName: document.id, title: document.title, path: document.path }
+                            : null),
+                    };
                 }
                 if (operation === 'read.tsdocs')
                     return { data: { scopes: [] } };
@@ -136,13 +195,13 @@ export function DocsLocalWorkspace(props) {
                     const response = await fetch(assetPath);
                     if (!response.ok)
                         return { error: new Error(`Unable to read local attachment (${response.status}).`) };
-                    return { data: await response.arrayBuffer() };
+                    return { data: (await response.arrayBuffer()) };
                 }
                 return { data: null };
             },
         };
         return adapter;
-    }, [description, homePath, pages, pathname, rootPath, title, tree]);
-    return (_jsx(TerraDocsWorkspace, { host: host, tree: tree, pathname: pathname, permission: 'read', title: page?.title ?? title, ...(page?.path ? { path: page.path } : {}), ...(page?.description ?? description ? { description: page?.description ?? description } : {}), ...(page?.contributors ? { contributors: page.contributors } : {}), ...(page?.updatedAt ? { updatedAt: page.updatedAt } : {}), ...(page ? { source: page.markdown, content } : { content }), ...(customBlocks ? { customBlocks } : {}) }));
+    }, [description, homePath, hue, pages, pathname, rootPath, title, tree]);
+    return (_jsx(TerraDocsWorkspace, { host: host, tree: tree, pathname: pathname, permission: "read", title: page?.title ?? title, ...(page?.path ? { path: page.path } : {}), ...(page?.description ? { description: page.description } : {}), ...(page?.contributors ? { contributors: page.contributors } : {}), ...(page?.updatedAt ? { updatedAt: page.updatedAt } : {}), ...(page ? { source: page.markdown, content } : { content }), ...(beforeContent !== undefined ? { beforeContent } : {}), ...(afterContent !== undefined ? { afterContent } : {}), ...(customBlocks ? { customBlocks } : {}), ...(blocks ? { blocks } : {}) }));
 }
 //# sourceMappingURL=LocalDocsWorkspace.js.map

package/lib-dist/components/LocalDocsWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDocsWorkspace.js","sourceRoot":"","sources":["../../src/components/LocalDocsWorkspace.tsx"],"names":[],"mappings":"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"}

package/lib-dist/components/NotFound.d.ts

@@ -0,0 +1,8 @@
+import type { JSX } from 'react';
+export type DocsNotFoundProps = {
+    appName?: string;
+    homeHref?: string;
+    description?: string;
+};
+export declare function DocsNotFound({ appName, homeHref, description, }: DocsNotFoundProps): JSX.Element;
+//# sourceMappingURL=NotFound.d.ts.map

package/lib-dist/components/NotFound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFound.d.ts","sourceRoot":"","sources":["../../src/components/NotFound.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAYjC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,OAAsB,EACtB,QAAc,EACd,WAAwE,GACzE,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAyBjC"}

package/lib-dist/components/NotFound.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, ButtonLink, Card, CardContent, CardDescription, CardFooter, CardHeader, CardHeading, } from '@terra-symposium/styling/ui/terra-original';
+export function DocsNotFound({ appName = 'Terra Docs', homeHref = '/', description = 'The page may have moved, or the link may be out of date.', }) {
+    return (_jsx("div", { className: "docs-theme-scope", children: _jsx("main", { className: "terra-docs-workspace flex items-center justify-center bg-background px-5 text-primary-12", children: _jsxs(Card, { variant: "primary-outline", size: "sm", className: "w-full text-center sm:max-w-lg", children: [_jsxs(CardHeader, { className: "items-center text-center", children: [_jsx(Badge, { variant: "destructive", size: "sm", rounded: "md", "aria-label": "Error 404", children: "404" }), _jsx(CardHeading, { as: "h1", className: "font-serif text-4xl italic tracking-tight", children: "Page not found" })] }), _jsx(CardContent, { className: "text-center", children: _jsx(CardDescription, { className: "text-base leading-relaxed", children: description }) }), _jsx(CardFooter, { className: "justify-center", children: _jsxs(ButtonLink, { href: homeHref, variant: "primary-tonal", size: "sm", children: ["Return to ", appName] }) })] }) }) }));
+}
+//# sourceMappingURL=NotFound.js.map

package/lib-dist/components/NotFound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFound.js","sourceRoot":"","sources":["../../src/components/NotFound.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,KAAK,EACL,UAAU,EACV,IAAI,EACJ,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,4CAA4C,CAAC;AAQpD,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,GAAG,YAAY,EACtB,QAAQ,GAAG,GAAG,EACd,WAAW,GAAG,0DAA0D,GACtD;IAClB,OAAO,CACL,cAAK,SAAS,EAAC,kBAAkB,YAC/B,eAAM,SAAS,EAAC,0FAA0F,YACxG,MAAC,IAAI,IAAC,OAAO,EAAC,iBAAiB,EAAC,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,gCAAgC,aAClF,MAAC,UAAU,IAAC,SAAS,EAAC,0BAA0B,aAC9C,KAAC,KAAK,IAAC,OAAO,EAAC,aAAa,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,IAAI,gBAAY,WAAW,oBAElE,EACR,KAAC,WAAW,IAAC,EAAE,EAAC,IAAI,EAAC,SAAS,EAAC,2CAA2C,+BAE5D,IACH,EACb,KAAC,WAAW,IAAC,SAAS,EAAC,aAAa,YAClC,KAAC,eAAe,IAAC,SAAS,EAAC,2BAA2B,YAAE,WAAW,GAAmB,GAC1E,EACd,KAAC,UAAU,IAAC,SAAS,EAAC,gBAAgB,YACpC,MAAC,UAAU,IAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAC,eAAe,EAAC,IAAI,EAAC,IAAI,2BAChD,OAAO,IACP,GACF,IACR,GACF,GACH,CACP,CAAC;AACJ,CAAC"}

package/lib-dist/components/SiteLayout.d.ts

@@ -0,0 +1,25 @@
+import type { DocsSection, DocsAttachment } from '../lib/workspace-types.js';
+import type { DocsNavNode } from './navigation.js';
+import type { JSX, ReactNode } from 'react';
+/**
+ * Compatibility adapter for static React sites.
+ *
+ * All navigation, page chrome, modes, and document rendering are delegated to
+ * the same TerraDocsWorkspace used by the local and remote host adapters.
+ */
+export declare function DocsSiteLayout({ title, homeHref, description, pageTitle, nodes, currentPath, hue, children, sections, attachments, rootPath, markdown, content, }: {
+    title: string;
+    homeHref?: string;
+    description?: string;
+    pageTitle?: string;
+    nodes: DocsNavNode[];
+    currentPath: string;
+    hue?: number | null;
+    children?: ReactNode;
+    sections?: DocsSection[];
+    attachments?: DocsAttachment[];
+    rootPath?: string;
+    markdown?: string;
+    content?: unknown;
+}): JSX.Element;
+//# sourceMappingURL=SiteLayout.d.ts.map

package/lib-dist/components/SiteLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SiteLayout.d.ts","sourceRoot":"","sources":["../../src/components/SiteLayout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAc,EACd,WAAW,EACX,SAAS,EACT,KAAK,EACL,WAAW,EACX,GAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,GAAG,CAAC,OAAO,CAkBd"}

package/lib-dist/components/SiteLayout.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DocsStaticWorkspace } from './StaticWorkspace.js';
+/**
+ * Compatibility adapter for static React sites.
+ *
+ * All navigation, page chrome, modes, and document rendering are delegated to
+ * the same TerraDocsWorkspace used by the local and remote host adapters.
+ */
+export function DocsSiteLayout({ title, homeHref = '/', description, pageTitle, nodes, currentPath, hue = 145, children, sections, attachments = [], rootPath, markdown, content, }) {
+    return (_jsx(DocsStaticWorkspace, { title: title, homeHref: homeHref, ...(description ? { description } : {}), ...(pageTitle ? { pageTitle } : {}), hue: hue, nodes: nodes, ...(sections ? { sections } : {}), currentPath: currentPath, ...(rootPath ? { rootPath } : {}), ...(markdown !== undefined ? { markdown } : {}), ...(content !== undefined ? { content } : {}), attachments: attachments, ...(children !== undefined ? { renderContent: children } : {}) }));
+}
+//# sourceMappingURL=SiteLayout.js.map

package/lib-dist/components/SiteLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SiteLayout.js","sourceRoot":"","sources":["../../src/components/SiteLayout.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,GAAG,GAAG,EACd,WAAW,EACX,SAAS,EACT,KAAK,EACL,WAAW,EACX,GAAG,GAAG,GAAG,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,GAAG,EAAE,EAChB,QAAQ,EACR,QAAQ,EACR,OAAO,GAeR;IACC,OAAO,CACL,KAAC,mBAAmB,IAClB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,KACd,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACpC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACpC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,KACR,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClC,WAAW,EAAE,WAAW,KACpB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC9B,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC5C,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC9C,WAAW,EAAE,WAAW,KACpB,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC/D,CACH,CAAC;AACJ,CAAC"}